home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / showf13.zip / SHOWFILE.DOC < prev    next >
Text File  |  1992-09-13  |  4KB  |  133 lines
  1.  
  2.                              -=( ShowFile 1.0 )=-
  3.  
  4. What is it:
  5. ===========
  6.  
  7. ShowFile is a little utility to show ascii textfiles on screen. No much more.
  8. BUT it allowes you to show different files for different template message
  9. and/or file area's (and of course any other file you like to show..;-)
  10. The user can use the PgUp, PgDn, Home and End to page through the file.
  11. Both the ANSI keyboard control character as well as the numbers on the
  12. numeric keyboard area recogniced.
  13.  
  14. How to:
  15. =======
  16.  
  17. ShowFile has the following commandline syntax:
  18.  
  19.    Showfile.EXE [-T:<TimeLimit>] [-N:*N] [-P:*P] [-NOS]
  20.                 <F:<FileName>> [-DIR:<Path>]
  21.  
  22.  
  23. -T:<TimeLimit>
  24.     sets a maximal time the user can spend in the door.
  25.     Example: -T:10  or -T:*T for the users maximal time.
  26.     Default is the time left according to the exitinfo.bbs.
  27.  
  28. -N:*N
  29.     Sets the nodenumber for the door.
  30.  
  31. -P:*P
  32.     For use on multiline systems with a single config.ra for all the lines.
  33.  
  34. -NOS
  35.     Local sound off for default. In this door it's only used for ^G characters
  36.     in a textfile.
  37.  
  38. -F:<FileName>
  39.     The name of the file to show. For default the file is searched in the
  40.     same directory as from where the EXE file has been started.
  41.     The homedirectory.
  42.  
  43. -DIR:<Path>
  44.     Set a path where the file can be found.
  45.  
  46.  
  47. How to use this door:
  48. =====================
  49.  
  50. Example 1: The echomail rules.
  51.  
  52. Make a directory RULES somewhere on your HD, and put the textfiles with the
  53. rules into this directory. Give every file the same name and use the
  54. areanumber as extention. F.e. AREARULE.1 for area 1, AREARULE.2 for area 2 etc.
  55.  
  56. Use the ShowFile utility like:
  57.  
  58.   ShowFile.exe -N:*N -P:*P -F:AREARULE.*1 -DIR:C:\RULES
  59.  
  60. The *0 translates into the current area-template number so the correct file
  61. is always shown.
  62.  
  63. Example 2: Info on file area's.
  64.  
  65. Let's say you want an infofile for every file area with the name of the
  66. co-sysop in charge and such. Make a textfile in every filearea directory
  67. named AREAINFO.BBS or something like it. Use ShowFile like:
  68.  
  69.   ShowFile.exe -N:*N -P:*P -F:AREAINFO.BBS -DIR:*0
  70.  
  71. This time the Directory changes with the template area.
  72.  
  73.  
  74. Example 3:
  75.  
  76. Of course you can use the door also for showing help and info files for doors
  77. etc. like:
  78.  
  79.   ShowFile.exe -N:*N -P:*P -F:TWINFO.DOC -DIR:C:\TRADEW
  80.  
  81. The advantage of this is that the user can page through the file.
  82.  
  83.  
  84. The title line:
  85. ===============
  86.  
  87. You can put a line, starting with %%, at the top of the text file. Everything
  88. after the %% will be used in the title line while showing. Default the
  89. filename is there.
  90.  
  91. F.e. The file TWARS.DOC will show
  92.  
  93.                                -=( TWARS.DOC )=-
  94.  
  95. on the title line until you put a line
  96.  
  97. %%Tradewars 2002, documentation.
  98.  
  99. in the file. Then it will show:
  100.  
  101.                     -=( Tradewars 2002, documentation. )=-
  102.  
  103.  
  104.  
  105. What else:
  106. ==========
  107.  
  108. Disclaimer: Use this door at your own risk. Etc. Etc.
  109.  
  110. Limits: The door has an internal limit of 999 lines, but cuts off earlier
  111.         if there's not enough memory. A line can be maximal 78 character long.
  112.         The rest is cut-off..
  113.  
  114. Features: DV awear, Multiline awear, uses filesharing, multilanguage,
  115.           etc. etc. The usual bunch..
  116.  
  117. CardWare:
  118.  
  119.  Ok.. I'm not going to ask money for thisone. If you like and use this door
  120.  please send a nice postcard to:
  121.  
  122.    Gerhard Hoogterp
  123.    Kremersmaten 108
  124.    7511 LC Enschede
  125.    The Netherlands.
  126.  
  127.  For comments and questions I can be reached at
  128.  
  129.   Gerhard Hoogterp
  130.   2:283/1.2
  131.   HOOGTERPG@HENUT5.BITNET
  132.   HOOGTERPG@UTWENTE.NL
  133.